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BACKGROUND OF THE INVENTION 

1. Field of the Invention 

5 This invention relates to the field of compilation and code generation of object 

code executable upon a computer. More particularly, the invention concerns compiling a 
data set from user-activated links within the comments portion of a program. The data set 
can thereafter be linked to procedure calls within an applications program to, for example, 
configure a logic device. 

10 

2. Description of the Related Art 

There may be numerous steps involved in creating a complex computer program. 
A program that can execute on a computer is often referred to as the object code or 
15 execution code. Such code is specific to the computer and, more particularly, to the 
specific execution unit of that computer. For example, the execution code may contain 
instructions indigenous to the microprocessor (or execution unit) of that computer. 

There are numerous types of programming languages that can be reduced to an 
20 execution code. One popular such language is the C programming language. Programs 
written in C can be assembled into an execution code listing specific to almost any 
execution unit. As such, the C programming language can support numerous types of 
execution units. 

25 In order to formulate execution code, it may be necessary to compile the code 

from a source file. Compilers are generally unique to various types of source files. Such 
compilers recognize particular source files and compile those source files into an 
execution code listing (object code) recognizable to the execution unit. 
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Compiling the source code into execution code can occur in various ways. For 
example, the user can write code in a text editor. Once the user is satisfied with the 
written code, he/she can then save the code to a file and perform syntax checks by parsing 
the code using a compiler. A utility program can then be used to assemble or generate the 
5 execution code, which can thereafter be stored as an output file. In the above 

methodology, the user writes and edits code in a text editor format and, when satisfied 
with what has been written, assembles the code in the final, execution code format. 



IU 




A more sophisticated code generation technique may be used, however. For 
10 example, the user may respond to a series of questions. Based on the user's response, a 
program file can be produced. The program file is a rudimentary form of the text editor 
file that can thereafter be modified by the user before running the assembler utility. By 
answering a sequence of questions, the user will invoke an application builder tool. 

tether code is compiled manually or through a series of questions, the 
conventional n^ethodology for code generation is through use of a text editor and, after 
text has been edited assembling that code into an object or execution file for use by the 
execution unit. Whilestext is easily understood by the human editor and thus files in text 
format are beneficial, generating code from a text editor is sometimes cumbersome and 
time consuming. Also, it is n^t easily determined by the user of the relationship between 
his/her edits made to the text ediW and the resulting, compiled code. It would be 
desirable to derive a less cumbersomfeyand less time-consumptive process of generating 
execution code. The desired process should also be one which can allow the user to 
easily and quickly edit text using a more recognized Graphical User Interface ("GUT'), 
25 and to visually track changes made using the GUIyto^resulting changes in a source file. 
These benefits are currently lacking in conventional cqde generation techniques 
employing text editors. 
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SUMMARY OF THE INVENTION 



Thejproblems outlined above are in large part solved by a code generation 
technique usin^inks placed within corresponding lines of text designated as comments 
of a program. Specifically, a program can be displayed on a display device in, for 
example, a windows-bas^format. Given that windows-based programs are graphic 
intensive, the links can be acceded by a pointer device connected to a computer which 
executes the windows program. By^recting the pointer device to the link contained in 
the same line as a comments designator oithe program, the link can be activated by 
clicking the pointer device, or otherwise actuating the pointer device. Once activated, the 
link may have associated pull-down menus for changing the link in accordance with a 
selection made by the pointer device. Whenever the vMue shown by the link is changed 
or modified, a corresponding field within a source data sents also changed. 



Advantageously, the comments portion of a program containing lines of text 
preceded by the comments descriptor (e.g., "//") can be displayed on the same screen, and 
possibly within the same window with the source or data file. Thus, any changes made to 
the link designator will appear in the comments portion, and the resulting changes will 
appear in the data set. In this manner, the user will be instantly apprised of the effect on 
the source or data file whenever he/she makes changes to a link designator. By placing 
the link as text within the same line as a program comment, the program comment can be 
written in text to represent anything whatsoever about the corresponding link. Changes to 
the comment text will have no effect whatsoever on the program, but will be highly 
descriptive of the link. By placing the link in the comments section of a program, the link 
is documented by the user with whatever words are most descriptive about the link. 
Additionally, the program is compiled after the comments are generated. In other words, 
the links can be built around the comments. Once the comments are written, links are 
added succeeding corresponding lines of textual comments. This is a reverse of normal 
program generation, where executable code is generated first, and then comments are 
added for documentation purposes only. 
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According to one exemplary use, the links can be accessed through a GUI for 
programming an interface between two sub-systems. There are numerous types of 
programmable^ interfaces or "programmable devices." Generally speaking, a 
programmable aeyice is any device that can be configured to achieve a specific logic 
function dependentspn a software program. In other words, the logic device can be 
designed generically\nd thereafter reconfigured through software to achieve a specific 
interface function. A popular programmable device can include gate arrays, logic arrays, 
and interface devices, eacV of which may be reconfigured in the field. The interface 
device can originally be designed as a general purpose interface device, which can later 
10 be reconfigured to achieve a specific purpose based on how that interface device is 
□ programmed. A General Purposfe Interface Device ("GPIF') can be programmed from 

the source or data set derived fromvalternations made to the present links. By changing 
IU the links within the comments portion of a program, a user can modify the data set 

:J3 (alternatively known as waveform descriptors in GPIF language) and then apply that data 

J5; 15 set to the execution unit of the GPIF. Thus, the data sets can be used by any execution 

^ unit, or by a particular execution unit applfcable to a GPIF. Regardless of its application, 

U \ 

s g the data sets can be easily modified and visually monitored within the same display 

O \ 
j i window as the modifiable links. 

20 According to one embodiment, a method is provided for generating computer 

executable code. The method includes compiling a data set by selecting a link within a 
comments portion of a program. The compiled data set can then be inserted into an 
applications program to form the computer executable code. The comments portion 
includes lines of text, each line preceding the text by a comments designator. One form 

25 of comments designator recognizable to a C programming platform is the "//" designator. 
The link can be selected by dragging an on-screen pointer to the link. When the pointer 
passes over the link, the link might change colors or otherwise become highlighted to 
note that the link is a "hot" link. A hot link is one that can be modified by clicking on the 
link to activate a pull-down menu. The pull-down menu might have different selections 

30 which can be chosen by the on-screen pointer. 
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According to another embodiment, a computer program is provided. The 
computer program may include a first line of text preceded by a comments designator and 
succeeded by at least one link word. The link word is alterable by selecting the link and 
the associated item within the pull-down menu, all of which is undertaken by the link 
word being displayed on a windows-based screen format and a graphical user interface. 
A second line of text can also be displayed within the window that accommodates the 
first line of text. The second line of text represents a data set that can change dependent 
on modifications to the link word by the on-screen pointer. As such, any modification to 
the link word will cause the data set to change. By viewing the window, a user can note 
in real-time any changes to the data set which result from changes to the link word, or 
vice- versa. This allows the user to view the effect of a link word modification. When the 
program is reloaded, the user can also note the effect on a link word by any preceding 
modification to one or more fields within the data set. 

According to yet another embodiment, an apparatus is provided. The apparatus 
may be used for generating programmable signals output from hardware. The hardware 
can include any device which can be alterable by a data set. The apparatus, therefore, 
includes a compiler for generating a data set containing at least one field of bits. The data 
set will change in response to changes of the link. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

Other objects and advantages of the invention will become apparent upon reading 
the following detailed description and upon reference to the accompanying drawings in 
5 which: 

Fig. 1 is a partial block diagram of a computer; 

Fig. 2 is a flow diagram of several steps used in compiling a data set and linking 
10 the data set to an applications program to form code that can execute upon an execution 
unit, such as that shown in Fig. 1; 



Fig. 3 is a plan diagram of a window presented upon the display of Fig. 1 
V containing links within a comments portion of a program, said links when activated by a 

n 15 user are selectable to generate, modify, alter, or otherwise compile byte fields within a 
^ data set also displayed upon the window; 



.{» Figs. 4-8 illustrate one example of which links within a comments portion of a 

j?i program are used to compile a data set, wherein Fig. 4 illustrates a compiled data set 

i*f 20 (stored as waveform descriptions) being used to program a logic device coupled between 

i 

a peripheral device and an execution unit; 

Fig. 5 is a state diagram of various operational states of the logic device, and the 
transitions that occur between states according to behavior, output, input and timing 
25 instructions contained within the data set; 

Fig. 6 is a window of a program containing a comments portion with certain links 
within the comments portion being user alterable such that changes to the user-alterable 
links will cause a corresponding change in a data field also displayed in the window; 

30 
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# • 

Fig. 7 is a timing diagram of a waveform configured from the data set (i.e., 
waveform descriptors) of Fig. 6, where such waveform is stored in memory and is 
thereafter useable by the logic device; and 

Fig. 8 is a compiled code fragment of executable code derived from a single read 
(or write) operation at interval 1 of Figs. 6 and 7. 

While the invention is susceptible to various modifications and alternative forms, 
specific embodiments thereof are shown by way of example in the drawings and will 
herein be described in detail. It should be understood, however, that the drawings and 
detailed description thereto are not intended to limit the invention to the particular form 
disclosed, but on the contrary, the intention is to cover all modifications, equivalents and 
alternatives falling within the spirit and scope of the present invention as defined by the 
appended claims. 
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DETAILED DESCRIPTION OF PREFERRED EMBODIMENTS 

Turning now to the drawings, Fig. 1 illustrates a computer 10. As with all 
computers, computer 10 includes an execution unit 12, and memory 14 linked to 
5 execution unit 12 by, for example, a memory controller. Memory 14 may be system 
memory, or semiconductor memory, or a combination of semiconductor memory and 
secondary memory, such as electromechanical or optical memory (i.e., disk drives, 
CDROMs, etc.). Within memory 14 are executable programs and files. For example, the 
memory may contain operating system programs and application programs. The 
10 operating system is used to initiate computer 10, while the application program can be 
used to run various application-specific routines. As will be noted further below, memory 
14 can also include a data set and execution code. Both the data set and execution code 
are assembled and/or compiled using various utility software programs, well-known to 
the skilled artisan. 



In addition to memory 14, various other devices can be linked to execution unit 
12. For example, a display 16 can be linked to execution unit 12 either on the local bus 
of the execution unit, a mezzanine bus, or peripheral bus. Display 16 includes any 
electronic display upon which an image or text can be presented. A suitable display 

20 includes a cathode ray tube, a liquid crystal display, etc. A peripheral device 18 can be 
linked directly to the local bus of execution unit 12 or, preferably, through a bus interface 
unit to execution unit 12. Peripheral device 18 can, for example, be linked to a PCI bus, 
SCSI bus, or any other well-known mezzanine or peripheral bus. Preferably, execution 
unit 12 is any device which can execute instructions. Popular such units include a 

25 processor or central processing unit ("CPU"). The processor can operate from an x86 
instruction set or a reduced instruction set ("RISC"). Peripheral device 18 includes any 
device that is located peripheral to execution unit 12 and includes a network interface 
card, video accelerator, audio card, hard or floppy disk drive, SCSI adapters, and/or 
telephony cards (modem), etc. 

30 
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Depending on whether the operating system program within memory 14 contains 
GUI programs, a pointer device 20 may be present. Pointer device 20 is any device which 
can move an on-screen pointer that appears on a window or screen-shot of display 16. 
The pointer device should also be capable of receiving user-actuation which translates to 
5 actuation of the on-screen pointer. A conventional pointer device 20 includes a mouse, 
light-pin, or any other device which can move the on-screen pointer a distance 
corresponding to movement of the pointer device across a surface. 



Fig. 2 is a flow diagram of steps used to compile a data set and, from that data set, 
10 additional steps used to compile execution code. According to one example, the 
q execution code may be used to configure output from a programmable device. Forming a 

!f: data set 22 begins by compiling the data set 23. Once compiled, the data set can be 

\ U linked, merged, or otherwise assembled within an applications program 24. The 

=n assembled applications program represents compiled executable code 26 resulting from 

12 15 the compiling or assembly step 28. In many C programming environments, a system 

utility is invoked to generate compiled code for application programs. Compiler products 
s {! can be obtained from various well-known vendors. 

H Data set 22 may include accessors for accessing object instances within an 

20 application program. It may be possible to generate updated executable code by merely 
redefining the data set 22 and re-linking the resulting object code, without necessarily 
recompiling the application program code. 

In accordance with one aspect, system software is augmented by enhanced code 
25 generation software for instructing the execution unit to carry out code generation and 
related operations. Such operations can include the configuration of the programmable 
device 30 is described herein below. Application program 24 and the compiled execution 
code 26 contain instructions describing the user interface and the configuration process, 
and can also include a high-level description of the desired programmable device circuit. 
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The execution code, according to one embodiment, can comprise calls to library elements 
(function calls) to libraries of software constructs of the hardware representation. 

Fig. 3 is a plan diagram, representing at least a portion of a screen-shot 32. 

5 Screen-shot 32 can be presented in windows-based format upon the display 16 of Fig. 1. 
The plan drawing 32 represents a window having a filename 34 and a toolbar 36. The 
filename and toolbar format is similar to that of any windows-based program, where 
differing files can be opened, closed, and edited. Contained within the working area of 
the window are two portions 38 and 40. Portion 38 includes lines of text 42 preceded by 

10 a text descriptor 44. One or more lines of text comments may include one or more words, 
hereinafter referred to as links. The comments section of the program code is, therefore, 
said to have active links (similar to internet URLs) that are used to select different 
configuration options and also to select behavior, timing and output of generated program 
code (execution code). The links represent a given area to which the on-screen pointer 

15 can be directed. When the on-screen pointer passes over the area associated with a link, 
the link will change colors or become highlighted to note the link is "hot." A hot link 
will present a pull-down menu. In the example shown, the hot link SYNC, noted as 
reference numeral 46, has an associated pull-down menu 48. The pull-down menu will 
be displayed on the working area of the window, where the on-screen pointer can then 

20 point to ASYNC if a change is desired to link 46. Importantly, the change will occur in 
the comments line that describes the significance of its associated link. In the example 
shown, comments line noted as "Timing" suggests that the timing can be either 
synchronized or asynchronized. Moreover, the comments line noted as "Data Bus Width" 
can depict the width of the data bus, where selection of the corresponding link allows the 

25 user to change between, for example, an 8-bit data bus width and a 16-bit data bus width. 

Any change to links within comments portion 38 will have a corresponding effect 
on the data set within portion 40. For example, if the SYNC link is changed to ASYNC, 
then a change is made to the corresponding field 50 within, for example, an OPCODE 
30 instruction. Accordingly, each link corresponds to a particular field within the data set. 
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For example, SYNC link may note a hex008a data field, while ASYNC link may note a 
different hex value within the same field of the data set corresponding to SYNC. A user 
will be able to note the correspondence between a link and its corresponding data set 
field. Any user-altered link will change the bit value within a corresponding field of the 
data set. 

The data set 40 can be displayed on the same window as the comments portion 38 
or, alternatively, comments portion 38 can be found on one window and data set 40 on 
another, with an appropriate toolbar and filename header 52 being associated with each 
window. Regardless of whether portions 38 and 40 are displayed within the same 
window or in different windows, any changes to a link will appear in the corresponding 
field of the data set. Conversely, any changes to a field of the data set will appear as 
changes to the corresponding link. Accordingly, if the value within field 50 is changed, 
link 46 will illustrate possibly ASYNC instead of SYNC. Reloading the program will 
effectuate a new textual reference within the area of the corresponding link. 

The data set is, therefore, deemed one that is compiled from a graphical user 
interface as links displayed in a text editor, along with support code to complete the 
working program. A user can evaluate the resulting code or data set 40 while always 
viewing the link 46 and the associated comments within portion 38. There is no context 
switch necessary for the user since the user is always looking at the changing code itself. 
The completed program is, therefore, self-documented. The user will not need to use an 
applications builder tool. Moreover, the code or data set is generated at the beginning of 
the process, rather than at the end of the process. The user is working real-time in the 
execution code domain by taking links within the comments field and turning those links 
into program code automatically. The hotspots and associated links serve as a general 
GUI for the documentation and configuration of executable code, and serves as a general 
GUI for the configuration of any embedded environment. The user that is always looking 
at a complete program file (or data file), and the program file may be updated by selecting 
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options at any time. Even after quitting and restarting, the user is always working in the 
program code domain, and the documentation is automatically updated. 

Example 

5 

Fig. 4 illustrates the programming of a programmable device or GPIF 60. Device 
60 is any device which can be programmed by software from a generic hardware 
configuration. Device 60 contains combinatorial and sequential logic, which may be 
configured in an array. Device 60, when used as an interface, is coupled between the 
10 execution unit 12 and the peripheral device 18. Device 60, when operating as an 

interface, is a hardware device that provides seamless interface between peripheral device 
^ 18 and execution unit 12. According to one example, the device operating as a GPIF can 

IIJ be configured to operate as an interface between a Universal Serial Bus ("USB") and the 

conventional parallel architecture of an execution unit. In this fashion, GPIF 60 allows a 
15 peripheral device to be one that can plug into a USB in seamless fashion. The USB can 
be configured on the external chassis, as a USB port of the computer. Output from GPIF 
a g 60 includes data address and control signals sent serially to the peripheral device over a 

rf. USB, where and GPIF 60 can receive an input signal such as a ready (RDY) signal. 

O Coupled to GPIF 60 is a memory element 62. Stored within memory element 62 is a data 

20 set that, according to the present example, can include waveform descriptors 64. 
Waveform descriptors are defined by the fields within a data set to control the GPIF 
output, and essentially tailor the data address and control outputs from device 60. 
Memory 62 can be a part of device 60 or separate from device 60. According to one 
example, memory 62 can be the same as memory 14, or can be within execution unit 12 
25 (shown in Fig. 1). Regardless of the location of memory 62, a data set can be stored 

within memory 62, and that data set can, therefore, represent a waveform output from the 
GPIF. The waveform is preferably compatible with the USB. In this manner, the GPIF 
can be an ASIC device to allow specific configuration of protocol within, e.g., a USB 
peripheral device and any execution unit. 
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Fig. 5 illustrates a state diagram of operational states within device 60 of Fig. 4. 
State diagram 66 illustrates three states in which the sequential machine within the device 
can reside. According to one example, the device can take on up to seven intervals, with 
the seventh interval being an idle state 68. Subsequent to the seventh interval, a first 
5 interval will occur. That interval can represent a non-decision point (NDP) interval or 
state 70. Alternatively, the first interval can be designated as a decision point (DP) 
interval 72. Any given NDP interval can delay a GPIF cycle using one or more wait 
states. That is, the output to the peripheral can be maintained for N rising edges of the 
interface clock. For any given DP interval, the GPIF cycle can branch to another interval 
10 depending on the logic state of two signals. The DP interval can also re-execute the same 
interval by incrementing the data output and address output by one value for each re- 
executed loop, shown as item 74. After the sixth interval, the state machine reverts back 
to the idle state 68. By designating up to seven intervals, a waveform can be depicted 
having seven intervals stored within the waveform descriptor. There may be multiple 
15 seven-interval descriptor tables, if necessary, to depict an entire output of the GPEF. The 
number of intervals is determined from the depth of the FIFO buffers which, in this 
example, stores up to seven intervals before an overflow condition occurs. The FIFO 
buffers are periodically reloaded with new waveform descriptors representative of each of 
the seven intervals. By periodically reloading the FIFO buffers and flushing the executed 
20 intervals, any waveform output from the GPIF can be programmed using the data set or 
waveform descriptors stored within the memory. 



Fig. 6 illustrates the relationship between a comments portion of a program and 
the corresponding data set fields which, in this example, are known as waveform 
descriptors. The comments portion 80, and waveform descriptors 82 are similar to the 
comments portion 38 and dap set portion 40 of Fig. 3. However, the primary difference 
is that the embodiment shown in Fig. 2 is applicable to a GPIF compiled instructional 
code, and the data set of Fig. 3 is generic to any application. 



.pi 
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Contained within the comments portion 80 are links which can be user-selected or 
modified. For sake of brevity, only two links 84 and 86 are shown being modified. Link 
84 will note that for the first interval (interval 1) the next data will not change, and will 
remain as the previous data or "Same Data." If the data output at interval 1 is to change 
to, for example, "Next Data," a user will actuate link 84 and make the appropriate change 
in the pull-down menu from "Same Data" to "Next Data." Any change to link 84 will 
appear in the second field of the "Op Code" command line of data set 82. Likewise, any 
change to the interface/wait line of interval 3 by changing the link 86 will cause a 
corresponding change in the fourth field of the length/branch ("Len Br") data set. 

^e layout of the comments portion 80 and the waveform descriptors 82 can apply 
r to any stractute" desired, and the example provided is only one of various ways in which 
to note behavior, riming, and output descriptions of a waveform. Thus, waveform 3 
("Wave 3") can be described in numerous ways, with the example of Fig. 6 indicating 
three different characteristics placed in three different description subcategories noted as 
length/branch ("Len Br"), "O^Code " and "Output." Each interval can have different 
selectable links and corresponding comments. In the example shown, the comments note 
a particular address and data mode a^seither the same value or next value address or the 
data mode being no data or activated data. Next data and interface/wait comments will 
20 note whether the next data will be updated or whether the data will be the same as the 
previous data and whether the GPIF will be stalled (i.e., waited one, two, three, or more 
interface clock cycles), or if an interface will occu\ Depending on whether the interval is 
in an DP state, various terms, such as Term A and Tenn B, can be combined according to 
a function (and/or/XOR) known as "LFunc." A DP interoal can be repeated or re- 




;iirte 



25 executed if the re-execute comment contains a link in that interval to activate the re- 

\ 

execute mode. Control outputs can also be modified to either l\^r0 states, as shown. 
The control outputs are needed to control the data and address signals forwarded from the 
GPIF to the peripheral device. If, in an DP interval, the LFunc is anXnd" and Terms A 

and B are at a logic high state, then the DP interval will transition to thertext interval only 

\ 

30 when the anded terms are met. Accordingly, if the ready input (RDY) is andfed with 
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* 



anotlW ready input (RDY), then DP will transition to the next interval only when the 
ready inpinJRDY) becomes active. Otherwise, DP may continue in, for example, its re- 
execute state iK^-execute is toggled on through a link in the comments portion 80. For 
sake of brevity, TermN^, Term B, LFunc, and Re-execute links are not shown since the 
setup of Fig. 6 is indicative^fa NDP interval, whereby data is read by the GPIF or 
written from the GPIF in intervdH^due to the data mode being activated. The details of 
the various text links and corresponding comments, and the data set of corresponding 



ln^g^coi 

fields is not applicable to the overall concep^of simply having links which can be 
activated and modified by a on-screen pointer, en\d corresponding fields within certain 
10 command lines of a data set which are modified accordingly. 



Using the example of Fig. 6, a waveform can be generated from the GPIF. The 
waveform will present an address and data within the first interval "il The address and 
data values are present in the first interval due to the data mode being activated, as shown 

15 in Fig. 6, in interval 1. Thereafter, data mode is no longer activated and neither an 

address nor data value is output from the GPIF. Note that during interval 2, a "Wait 2" 
link is asserted causing two cycles of the interface clock (IF CLK) to occur between 
interval 1 and interval 3. The control output transitions to an active low value at interval 
1, and remains in that low value until changed by the user. Although it is understood that 

20 seven intervals are present, only four intervals are shown for brevity. 

Fig. 8 illustrates compiled execution code in C language platform for a single read 
operation. Single read can correspond to the single read which occurs during the first 
interval, il, shown in Fig. 7. Fig. 8, therefore, indicates the mechanism by which the data 
25 set, or waveform descriptor 82 shown in Fig. 6 can be compiled or assembled into object 
code recognizable to the GPIF. The GPIF will perform a single read as instructed by the 
user's input to comments portion 80 and the resulting data set instructions in portion 82, 
whereby portion 82 is reduced to executable code shown in Fig. 8. 
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It will be appreciated to those skilled in the art having the benefit of this 
disclosure that the embodiments described are believed applicable to the programming of 
any system which can execute from object code. The object code is assembled from 
source code and an application program derived from a data set. The data set is any file 

5 or data set in memory containing data that is derived from user-activated links within a 
comments portion of a program. One example of a system that can execute from object 
code is a GPIF. It is noted, however, that the overall concept of using links and 
presenting those links in a comments portion of the program are not limited to a GPIF 
embodiment. Accordingly, the specification and drawings are to be regarded in an 

10 illustrative, rather than a restrictive sense as to possibly numerous types of programmable 
hardware devices, architecture, circuitry, and methodologies which fall within the spirit 
and scope of the present invention. 
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